FocusWithCursor

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODStorageUnit

FocusWithCursor
The FocusWithCursor method focuses this storage unit on the focus context represented by the specified storage-unit cursor.
ODStorageUnit FocusWithCursor (
                           in ODStorageUnitCursor cursor);
cursor
A reference to the storage-unit cursor representing the desired focus context.
return value
A reference to this storage unit, focused on the specified focus context.

DISCUSSION
After this method executes successfully, this storage unit's offset is 0.
Before calling this method, you can call the ExistsWithCursor method to check whether the specified focus context exists.

EXCEPTIONS

kODErrIllegalNullSUCursorInput
The cursor parameter is null.
kODErrPropertyDoesNotExist
The cursor parameter specifies a property that does not exist.
kODErrSUValueDoesNotExist
The cursor parameter specifies a value type that does not exist for the specified property.
kODErrValueIndexOutOfRange
The cursor parameter specifies a value index that is out of the range for the specified property.
kODErrZeroRefCount
This storage unit has a reference count of 0.

SEE ALSO
The ODStorageUnit::ExistsWithCursor method (page 682).
The ODStorageUnit::Focus method (page 684).
"Focusing a Storage Unit" on page 274 in OpenDoc Programmer's Guide.